home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / gfx / show / vmpeg.readme < prev    next >
Encoding:
Text File  |  1999-09-06  |  6.1 KB  |  170 lines
  1. Short:    WarpOS port of MPEG2 video decoder
  2. Author:   frank@phoenix.owl.de (Frank Wille)
  3. Uploader: frank@phoenix.owl.de
  4. Version:  0.3
  5. Type:     gfx/show
  6. Requires: CSPPC or BPPC, WarpOS V4 (powerpc.library V15), AHI
  7.  
  8. vmpeg is another MPEG1/2 video player, based on the public source of
  9. the MPEG Software Simulation Group.
  10.  
  11. The last days I checked all MPEG players for the Amiga, but found no
  12. one which is able to play a standard 352x288 MPEG movie with sound
  13. in real time. This one does - at least with a 604e/233 and a fast
  14. graphics board (a 200 MHz 604e is already critical).
  15.  
  16.  
  17. FEATURES
  18.  
  19. - Cybergraphics/Picasso96 support (8-bit dithered or 15/16/32 bit
  20.   true color). Either by direct frame buffer access (-o4) or by using
  21.   Cybergraphics (-o5, very slow).
  22.  
  23. - Picasso96 PIP support (-o6).
  24.  
  25. - Automatic centering on graphics boards, in case the screen mode is
  26.   larger than the required display.
  27.  
  28. - Audio support via ahi.device unit 0.
  29.  
  30. - Tries to run at natural frame rate. When it's running too fast,
  31.   the player will wait after every frame, and when running too slow it
  32.   will start skipping B-frames. This should prevent interruptions of
  33.   audio output.
  34.  
  35. - Option -a prevents frame-skipping and plays all frames. Sound will
  36.   be disabled.
  37.  
  38. - User may define the fps-rate, used for replay (-d). Sound will be
  39.   disabled.
  40.  
  41. - Fps counter display.
  42.  
  43. - Time code display.
  44.  
  45. - Backward/Forward seek function. You can scan through the whole
  46.   movie by using the mouse.
  47.  
  48. - Several work-arounds to be compatible with all movies I have seen.
  49.  
  50. - Compiled by latest vbcc in highest optimization mode.
  51.  
  52. - Some PPC Assembler optimizations.
  53.  
  54.  
  55. USAGE
  56.  
  57. To view a movie with sound enabled just type
  58.  
  59.   vmpeg -o4 -s -b cd0:movie.mpg
  60.  
  61. A screen mode requester will open where you can select your prefered
  62. resolution. 8 bit screens automatically force dithering mode. You should
  63. define a screen mode with a resolution of 352x288 pixels. vmpeg runs
  64. best at 15/16 bits, which is even faster than 8 bit.
  65.  
  66. Pressing the right mouse button will display the current time code.
  67. When moving the mouse right or left, while holding the right button,
  68. you can seek for/backwards in the MPEG stream. Move the mouse very
  69. slowly! The stream is seeked in multiples of 1 MB. By looking at the
  70. time code you should easily find the position where you last stopped
  71. watching the movie.
  72.  
  73. Backwards seeking is nearly unusable with FastFileSystem in large
  74. files, but works very well with others, like a CD-FileSystem or PFS/SFS.
  75.  
  76. To quit, press the left mouse button or the ESC key.
  77.  
  78. For more options, you may start vmpeg without arguments to get a
  79. complete list.
  80.  
  81.  
  82. FIXED BUGS SINCE 0.1
  83.  
  84. - -m option to select screen mode id didn't work
  85.  
  86. - All screen modes only worked for some graphics boards (e.g. CV64
  87.   and PicaossIV). On other boards, only a few modes worked (e.g.
  88.   on CVPPC and BVPPC).
  89.  
  90.  
  91. BUGS
  92.  
  93. - Slow down of fast movies could work better, when having sound enabled.
  94.  
  95. - True color display modes doesn't support other chroma formats
  96.   or interlaced movies. Haven't seen those, though.
  97.  
  98. - Fps counter seems to be wrong in fast movies (?).
  99.  
  100.  
  101. SOURCE
  102.  
  103. Full source code is included. To recompile, you need the latest vbcc
  104. compiler and a make-program (the makefile is very simple, so that
  105. most 'makes' should work). If you have problems, try a lower optimization
  106. mode, or write me to get a compiler update.
  107.  
  108.  
  109. LEGAL
  110.  
  111. vmpeg is freeware, of course.
  112.  
  113.  
  114. Frank Wille                  27-Jun-1999                frank@phoenix.owl.de
  115.  
  116.  
  117. ============================= Archive contents =============================
  118.  
  119. Original  Packed Ratio    Date     Time    Name
  120. -------- ------- ----- --------- --------  -------------
  121.   234300   74659 68.1% 28-Jun-99 19:08:30  vmpeg
  122.     3482    1762 49.3% 05-Jul-99 21:17:48  vmpeg.readme
  123.    42362    8113 80.8% 05-Jul-99 21:20:26 +amidisplay.c
  124.    12138    3674 69.7% 05-Jul-99 21:20:28 +audio.c
  125.      257     126 50.9% 05-Jul-99 21:20:28 +audio.h
  126.     1866     705 62.2% 05-Jul-99 21:20:28 +audioPPC.s
  127.     2747    1397 49.1% 05-Jul-99 21:20:28 +CHANGES
  128.     1539     748 51.3% 05-Jul-99 21:20:28 +config.h
  129.    33674    6004 82.1% 05-Jul-99 21:20:28 +display.c
  130.     1488     557 62.5% 05-Jul-99 21:20:28 +EXAMPLES
  131.     5412    1799 66.7% 05-Jul-99 21:20:26 +getbits.c
  132.    12737    2585 79.7% 05-Jul-99 21:20:28 +getblk.c
  133.    30392    6855 77.4% 05-Jul-99 21:20:26 +gethdr.c
  134.    35507    9649 72.8% 05-Jul-99 21:20:26 +getpic.c
  135.    15532    3104 80.0% 05-Jul-99 21:20:26 +getvlc.c
  136.    20126    3315 83.5% 05-Jul-99 21:20:28 +getvlc.h
  137.    21053    5384 74.4% 05-Jul-99 21:20:28 +global.h
  138.     5757    2080 63.8% 05-Jul-99 21:20:28 +idct.c
  139.     7126    2038 71.4% 05-Jul-99 21:20:28 +idctPPC.s
  140.     2886    1370 52.5% 05-Jul-99 21:20:26 +idctref.c
  141.    11486    1804 84.2% 05-Jul-99 21:20:28 +IEEE1180
  142.     1283     474 63.0% 05-Jul-99 21:20:28 +layer_data.i
  143.     4359    1539 64.6% 05-Jul-99 21:20:28 +Makefile
  144.     7026    2147 69.4% 05-Jul-99 21:20:26 +motion.c
  145.    21198    6429 69.6% 05-Jul-99 21:20:26 +mpeg2dec.c
  146.     4586    1630 64.4% 05-Jul-99 21:20:28 +mpeg2dec.h
  147.    23781    6890 71.0% 05-Jul-99 21:20:28 +common.c
  148.    17771    4401 75.2% 05-Jul-99 21:20:28 +common.h
  149.    22957    5592 75.6% 05-Jul-99 21:20:28 +decode.c
  150.     7227    1761 75.6% 05-Jul-99 21:20:28 +decoder.h
  151.    14667    3052 79.1% 05-Jul-99 21:20:28 +encoder.h
  152.     7265     266 96.3% 05-Jul-99 21:20:30 +alloc_0.h
  153.     7283     265 96.3% 05-Jul-99 21:20:30 +alloc_1.h
  154.     6824     222 96.7% 05-Jul-99 21:20:30 +alloc_2.h
  155.     6848     228 96.6% 05-Jul-99 21:20:30 +alloc_3.h
  156.     5277    1689 67.9% 05-Jul-99 21:20:28 +dewindow.h
  157.     1386     709 48.8% 05-Jul-99 21:20:28 +README
  158.    15541    3621 76.7% 05-Jul-99 21:20:26 +recon.c
  159.     6032    1694 71.9% 05-Jul-99 21:20:28 +SPATIAL.DOC
  160.     9492    2416 74.5% 05-Jul-99 21:20:26 +spatscal.c
  161.    14950    3703 75.2% 05-Jul-99 21:20:26 +store.c
  162.    10620    3457 67.4% 05-Jul-99 21:20:26 +subspic.c
  163.     6342    2028 68.0% 05-Jul-99 21:20:26 +systems.c
  164.     6796    6753  0.6% 05-Jul-99 21:20:28 +test.m2v
  165.     2352    1277 45.7% 05-Jul-99 21:20:28 +TODO
  166.     8639    2726 68.4% 05-Jul-99 21:20:26 +verify.c
  167.    11365    1555 86.3% 05-Jul-99 21:20:28 +writeframe.s
  168. -------- ------- ----- --------- --------
  169.   753734  204252 72.9% 07-Jul-99 16:05:54   47 files
  170.